MCP 문서 관리

메뉴

Apple Script

Apple Script

Apple Script MCP 서버는 LLM(Large Language Models)이 macOS 시스템에서 AppleScript 코드를 실행하여 시스템의 모든 기능을 완전히 제어할 수 있게 해주는 커뮤니티 서버입니다. 이 서버는 설정이 간단하고 직관적이며, Mac에서 다양한 작업을 자동화할 수 있는 강력한 도구입니다.

특징

  • 완전한 macOS 시스템 제어: AppleScript를 통해 운영체제의 모든 기능에 접근
  • 최소한의 설정: 별도의 설정이나 복잡한 구성 없이 빠르게 사용 가능
  • 간결한 구현: 핵심 코드가 100줄 미만으로 간단하지만 강력함
  • Mac 애플리케이션 통합: 시스템 애플리케이션 및 서드파티 앱과의 상호작용
  • 워크플로 체인: 여러 명령을 연결하여 복잡한 자동화 워크플로 생성 가능

API

도구

execute_applescript

AppleScript 코드를 실행하는 도구입니다. - 입력: AppleScript 코드 문자열 - 출력: 스크립트 실행 결과

get_system_info

현재 macOS 시스템에 대한 정보를 가져오는 도구입니다. - 입력: 없음 - 출력: 운영체제 버전, 하드웨어 정보 등 시스템 세부 정보

list_applications

설치된 애플리케이션 목록을 가져오는 도구입니다. - 입력: 없음 - 출력: 설치된 애플리케이션 목록

사용 방법

설치

# npm을 통한 설치
npm install -g @peakmojo/applescript-mcp

# 또는 uvx 사용
uvx applescript-mcp

구성

Claude Desktop에서 이 서버를 사용하려면 다음과 같이 설정 파일에 추가합니다:

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

사용 예시

// 시스템 알림 표시하기
tell application "System Events"
  display notification "Hello from Claude" with title "MCP Test"
end tell

// Finder에서 파일 조작하기
tell application "Finder"
  make new folder at desktop with properties {name:"MCP Demo"}
end tell

// 애플리케이션 실행하기
tell application "Safari"
  activate
  open location "https://www.example.com"
end tell

연결된 구성 요소

주의사항

이 서버는 macOS 운영체제에 대한 전체 접근 권한을 제공하므로, 신뢰할 수 있는 환경에서만 사용해야 합니다. 실행되는 AppleScript 코드를 항상 검토하고, 코드의 출처를 신중하게 확인하세요. 특히 보안이 중요한 환경에서는 필요한 권한만 허용하는 것이 좋습니다.